home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / opengldoc / glspec / shadow.spec < prev    next >
Encoding:
Text File  |  1996-11-11  |  4.4 KB  |  154 lines
  1. XXX - Not complete yet!!!
  2.  
  3. Name
  4.  
  5.     SGIX_shadow
  6.  
  7. Name Strings
  8.  
  9.     GL_SGIX_shadow
  10.  
  11. Version
  12.  
  13.     $Date: 1996/04/02 00:08:38 $ $Revision: 1.2 $
  14.  
  15. Number
  16.  
  17.     34
  18.  
  19. Dependencies
  20.  
  21.     None.
  22.  
  23. Overview
  24.  
  25.     This extension defines two new operations to be performed on texture
  26.     values before they are passed on to the filtering subsystem.  These
  27.     operations perform either a <= or >= test on the value from texture
  28.     memory and the iterated R value, and return 1.0 or 0.0 if the test
  29.     passes or fails, respectively.
  30.     
  31. New Procedures and Functions
  32.  
  33.     None
  34.  
  35. New Tokens
  36.  
  37.     Accepted by the <pname> parameter of TexParameterf, TexParameteri,
  38.     TexParameterfv, TexParameteriv, GetTexParameterfv, and
  39.     GetTexParameteriv, with the <pname> parameter of TRUE or FALSE:
  40.  
  41.     TEXTURE_COMPARE_SGIX
  42.  
  43.     Accepted by the <pname> parameter of TexParameterf, TexParameteri,
  44.     TexParameterfv, TexParameteriv, GetTexParameterfv, and
  45.     GetTexParameteriv:
  46.  
  47.     TEXTURE_COMPARE_OPERATOR_SGIX
  48.  
  49.     Accepted by the <param> parameter of TexParameterf and TexParameteri,
  50.     and by the <params> parameter of TexParameterfv and TexParameteriv,
  51.     when their <pname> parameter is TEXTURE_COMPARE_OPERATOR_SGIX:
  52.  
  53.     TEXTURE_LEQUAL_R_SGIX
  54.     TEXTURE_GEQUAL_R_SGIX
  55.  
  56. Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
  57.  
  58.     None
  59.  
  60. Additions to Chapter 3 of the 1.0 Specification (Rasterization)
  61.  
  62.     XXX - lots
  63.  
  64.     GL Specification Table 3.8 is updated as follows:
  65.  
  66.     Name                Type        Legal Values
  67.     ----                ----        ------------
  68.     TEXTURE_WRAP_S            integer        CLAMP, REPEAT
  69.     TEXTURE_WRAP_T            integer        CLAMP, REPEAT
  70.     TEXTURE_WRAP_R_EXT        integer        CLAMP, REPEAT
  71.     TEXTURE_MIN_FILTER        integer        NEAREST, LINEAR,
  72.                             NEAREST_MIPMAP_NEAREST,
  73.                             NEAREST_MIPMAP_LINEAR,
  74.                             LINEAR_MIPMAP_NEAREST,
  75.                             LINEAR_MIPMAP_LINEAR,
  76.                             FILTER4_SGIS,
  77.                             LINEAR_CLIPMAP_LINEAR_SGIX
  78.     TEXTURE_MAG_FILTER        integer        NEAREST, LINEAR,
  79.                             FILTER4_SGIS,
  80.                             LINEAR_DETAIL_SGIS,
  81.                             LINEAR_DETAIL_ALPHA_SGIS,
  82.                             LINEAR_DETAIL_COLOR_SGIS,
  83.                             LINEAR_SHARPEN_SGIS,
  84.                             LINEAR_SHARPEN_ALPHA_SGIS,
  85.                             LINEAR_SHARPEN_COLOR_SGIS,
  86.     TEXTURE_BORDER_COLOR        4 floats    any 4 values in [0,1]
  87.     DETAIL_TEXTURE_LEVEL_SGIS    integer        any non-negative integer
  88.     DETAIL_TEXTURE_MODE_SGIS    integer        ADD, MODULATE
  89.     TEXTURE_MIN_LOD_SGIS        float        any value
  90.     TEXTURE_MAX_LOD_SGIS        float        any value
  91.     TEXTURE_BASE_LEVEL_SGIS        integer        any non-negative integer
  92.     TEXTURE_MAX_LEVEL_SGIS        integer        any non-negative integer
  93.     GENERATE_MIPMAP_SGIS        boolean        TRUE or FALSE
  94.     TEXTURE_CLIPMAP_OFFSET_SGIX    2 floats    any 2 values
  95.     TEXTURE_COMPARE_SGIX        boolean        TRUE or FALSE
  96.     TEXTURE_COMPARE_OPERATOR_SGIX    integer        TEXTURE_LEQUAL_R_SGIX,
  97.                                                 TEXTURE_GEQUAL_R_SGIX
  98.  
  99.     Table 3.8: Texture parameters and their values.
  100.  
  101.     Notes:
  102.  
  103.     * Two new texture operators are defined which alter the sampled texture
  104.     values before they are filtered.  These operators are defined only for
  105.     textures with internal format DEPTH_COMPONENT or DEPTH_COMPONENTS*_SGI.
  106.  
  107.     * The new operators compare the sample texel value to the value of the
  108.     third texture coordinate, R.  The texture components are treated as though
  109.     they range from 0.0 through 1.0.  The value of the test is zero if the
  110.     test fails, and one if it passes.
  111.  
  112.     * The test for operator TEXTURE_LEQUAL_R_SGIX passes if the texel value
  113.     is less than or equal to R.     The test for operator TEXTURE_GEQUAL_R_SGIX
  114.     passes if the texel value is greater than or equal to R.
  115.  
  116. Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations
  117. and the Frame Buffer)
  118.  
  119.     None
  120.  
  121. Additions to Chapter 5 of the 1.0 Specification (Special Functions)
  122.  
  123.     None
  124.  
  125. Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
  126.  
  127.     The texture compare operator is queried by calling GetTexParameteriv
  128.     and GetTexParameterfv with <pname> set to
  129.     TEXTURE_COMPARE_OPERATOR_SGIX.  Texture compare enable/disable state
  130.     is queried by calling GetTexParameteriv or GetTexParameterif with
  131.     <pname> TEXTURE_COMPARE_SGIX.
  132.     
  133. Additions to the GLX Specification
  134.  
  135.     None
  136.  
  137. Errors
  138.  
  139.     INVALID_OPERATION is generated if TexParameter[if] parameter <pname>
  140.     is TEXTURE_COMPARE_OPERATOR_SGIX and parameter <param> is not
  141.     TEXTURE_LEQUAL_R_SGIX,or TEXTURE_GEQUAL_R_SGIX.
  142.  
  143. New State
  144.  
  145. Get Value            Get Command        Type    Initial Value        Attribute
  146. ---------            -----------        ----    -------------        ---------
  147. TEXTURE_COMPARE_SGIX        GetTexParameter[if]v    B    False            texture
  148. TEXTURE_COMPARE_OPERATOR_SGIX    GetTexParameter[if]v    Z_2    TEXTURE_LEQUAL_R_SGIX    texture
  149.     
  150.  
  151. New Implementation Dependent State
  152.  
  153.     None
  154.